home *** CD-ROM | disk | FTP | other *** search
/ Experimental BBS Explossion 3 / Experimental BBS Explossion III.iso / sound / sbank110.zip / SBANK.TXT < prev   
Text File  |  1993-04-06  |  8KB  |  193 lines
  1. SBANK Version 1.10                                      12-08-92
  2.  
  3.  
  4. SBANK  is  a  command  line utility for  managing  Sound  Blaster
  5. and   Adlib   instrument  files  and  sound   banks.    It   will
  6. translate   between  .INS,  .SBI,  .BNK,  and  .IBK   files.   In
  7. addition,  it  will  report  instrument  names  stored  in   bank
  8. files,   and   display  musical  parameters  contained   in   the
  9. instrument definitions.
  10.  
  11. Usage: SBANK BankFile [-AUMDXLVSTI?] [BankFile|Instrument...]
  12.  
  13.      BankFile       is the name or path of a BNK or IBK instrument
  14.                     bankfile -- It will be created if appropriate.
  15.      Instrument     is the name of an instrument or the name or 
  16.                     path of an .INS or .SBI instrument file.
  17.      
  18.  
  19. OPTIONS
  20.  
  21. Option  letters  are  case insensitive and  may  be  preceded  by
  22. either - or /.   They specify the operations to perform.
  23.  
  24.   -A append the specified instruments (INS or SBI files) to
  25.      the named bank file.  Wildcards (* and ?) may be used 
  26.      to select the instrument files.  The bank file is created  
  27.      if it does not exist.  Duplicate instrument names in the  
  28.      bank file are not updated unless the -U option also appears.
  29.  
  30.   -U update the specified existing instruments in the named
  31.      bank  file.   Wildcards are allowed.  Specified instruments
  32.      that do not exist are not added unless the -A option also
  33.      appears.
  34.  
  35.   -M move the specified instruments to the named bank file.
  36.      Specifying  -M implies both append and update.  After  a
  37.      successful  insertion,  the  instrument  file  is  deleted.
  38.      Wildcards are allowed.
  39.  
  40.   -D delete and discard the named instruments from the bank
  41.      file.  This can be used with the -X option to remove an
  42.      instrument from a bank file.
  43.  
  44.   -X extract the named instruments from the bank file.  The
  45.      type of instrument file to create is determined from the
  46.      filename suffix.
  47.  
  48.   -L list the names of the instruments contained in the bank
  49.      file.  This option formats the names one per line.  Only
  50.      instrument names are displayed. It is useful for creating
  51.      input for command line filters or file redirection.
  52.  
  53.   -V list the names of the instruments contained in the bank
  54.      file.  The instruments are formatted eight names to a line
  55.      in the same order they are encountered in the bank file.
  56.      For a BNK file, they will be sorted alphabetically; for an
  57.      IBK  bank,  they  are presented in the order  they  were
  58.      appended.  This is also the order of increasing MIDI 
  59.      program change numbers.
  60.  
  61.   -S show the parameters for an instrument or instruments.
  62.      This  option  formats  and displays  the  parameters  that
  63.      comprise the instrument sound.
  64.  
  65.   -T translate from one file type to another.  For this option
  66.      the first named file is the source and the second is the
  67.      target.  This is the only option that will operate between
  68.      instrument files as well as between bank files.  If  the
  69.      source and target are bank files, this option acts as a
  70.      merge command, merging the source into the target; and the
  71.      -I ListFile option may be used to select instruments to
  72.      translate.
  73.  
  74.   -I FName specifies an ASCII text file containing a list of
  75.      instrument names to be used when translating between  two
  76.      bank  files.  This  file should be  formatted  with  one
  77.      instrument name per line. The -L option will output a list
  78.      in the proper format, which may be redirected to a file, and
  79.      then edited (See Examples).
  80.  
  81.   -? display brief help information.
  82.  
  83.  
  84. NOTES
  85.  
  86. When  possible,  file  types are determined from  their  internal
  87. structure  rather  than the external file  name  extension.   The
  88. program  can  translate  each of the four  file  types  into  any
  89. of  the  other  types  (including its own type).   It  should  be
  90. noted  that  the  SBI  and IBK file types do not  include  fields
  91. for  percussive  mode  and  voice number.   This  information  is
  92. lost  when  converting between them and BNK  or  INS  file  types
  93. (the mode is always  melodic in SBI and IBK files).
  94. When  displaying  parameters,  the  following  abbreviations  and
  95. ranges are used:
  96.  
  97. Abbrev    Meaning                  Range     Notes
  98.  
  99. KSL       Level Scaling            00 - 03
  100. FQM       Frequency Multiplier     00 - 14
  101. FB        Feedback                 00 - 07  Used by Modulator only
  102. ATK       Attack                   00 - 15
  103. DCY       Decay                    00 - 15
  104. SLV       Sustain Level            00 - 15  (15 - 0) See Note Below
  105. RLS       Release                  00 - 15
  106. LVL       Output Level             00 - 63  (63 - 0) See Note Below
  107. SUS       Sustaining Sound         No - Yes
  108. AM        Amplitude Modulation     No - Yes Tremolo
  109. VIB       Pitch Modulation         No - Yes Vibrato
  110. KSR       Envelope Scaling         No - Yes
  111. WAV       Wave Select              00 - 03  Waveform Distortion
  112. CON       Connection               FM - AS  Only used by Modulator
  113. MOD       Mode                     MLD-PRC  Only used by INS and BNK
  114. V#        Voice Number             06 - 10  Only used by INS and BNK
  115.  
  116.  
  117. The  actual  number  stored for SLV and  LVL  is  an  attenuation
  118. level:   the  higher  the  number, the softer  the  sound.   What
  119. is displayed is the reverseof this number.
  120.  
  121. As  noted  above,  the MOD and V# fields are  only  used  in  INS
  122. and  BNK  file  formats,  MOD will always  be  melodic  (MLD)  in
  123. SBI and IBK files.
  124.  
  125. When  using  the  -V  option on a BNK file, both  the  number  of
  126. defined  instruments  and  the  current  capacity  is  displayed.
  127. The  current  capacity  of  a  BNK  file  is  increased  when  it
  128. becomes  filled.   IBK  bank  files always  have  a  capacity  of
  129. 128   instruments.   This  corresponds  to  one  instrument   for
  130. each MIDI program change number.
  131.  
  132.  
  133. EXAMPLES
  134.  
  135. Following  are  a  few  examples  to  demonstrate  the  kinds  of
  136. operations that can be performed with SBANK:
  137.  
  138. C:\> sbank standard.bnk -x myins\b??.sbi
  139.  
  140. This    will   extract   from   STANDARD.BNK,   all   instruments
  141. matching  B,  B?  and B??, convert them to SBI files,  and  place
  142. them in theMYINS subdirectory.
  143.  
  144. C:\> sbank /s standard.bnk abrss1 x*
  145.  
  146. This  will  display  the  parameters for the  ABRSS1  instrument,
  147. and all instruments matching X*.
  148.  
  149. C:\> sbank standard.bnk -l >verylong.lst
  150.  
  151. This  will  display  the  name  of  each  instrument  stored   in
  152. STANDARD.BNK   but   redirect   the   output    to    the    file
  153. VERYLONG.LST.   It  will  most  likely  be  a  very  long   list!
  154. This  list  may  be  edited by any text editor  and  subsequently
  155. used as an instrument list for translating bank files:
  156.  
  157. C:\> sbank standard.bnk /t new.ibk /i verylong.lst
  158.  
  159. Will  create  a  NEW.IBK  bank  file containing  the  instruments
  160. in STANDARD.BNK which are listed in VERYLONG.LST.
  161.  
  162. C:\> sbank -au new.bnk *.ins C:\SBI\*.sbi
  163.  
  164. This  will  Append  or Update to NEW.BNK, all the  INS  files  in
  165. the  current  directory,  and all the SBI  files  in  the  C:\SBI
  166. directory.
  167.  
  168. C:\> sbank my.ibk abrss1.ins -m
  169.  
  170. This  will  Append  the  ABRSS1.INS  instrument  to  MY.IBK   and
  171. then erase the ABRSS1.INS file - if all goes well.
  172.  
  173. C:\> sbank my.ibk /d abrss1
  174.  
  175. This deletes the ABRRS1 instrument from MY.IBK
  176.  
  177. C:\> sbank my.ibk ?a* -v
  178.  
  179. Will  display  all  of  the  instrument  names  in  my.ibk  which
  180. have  "A"  as  the  second letter.  The names will  be  formatted
  181. eight to a line.
  182.  
  183. C:\> sbank piano1.sbi piano1.ins -t
  184.  
  185. This   will  convert  the  PIANO1.SBI  instrument  file  into   a
  186. PIANO1.INS file.
  187.  
  188. C:\> sbank piano1.ins -s
  189.  
  190. This  will  display  the  parameters for  the  PIANO1  instrument
  191. contained in PIANO1.INS.
  192.  
  193.